Leadtools.ColorConversion Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
ConvertDirect(ConversionColorFormat,ConversionColorFormat,Byte[],Int32,Byte[],Int32,Int32,Int32,Int32,Int32) Method
See Also  Example
Leadtools.ColorConversion Namespace > RasterColorConverter Class > ConvertDirect Method : ConvertDirect(ConversionColorFormat,ConversionColorFormat,Byte[],Int32,Byte[],Int32,Int32,Int32,Int32,Int32) Method



srcFormat
Format of the input data.
destFormat
Format of the output data.
srcBuffer
A byte array containing the input buffer.
srcBufferOffset
Offset to the first byte of the srcBuffer data buffer.
destBuffer
A byte array that will hold the converted data.
destBufferOffset
Offset to the first byte of the destBuffer data buffer.
width
Width of pixels to be processed.
height
Height of pixels to be processed.
inAlign
Each scanline in the input buffer is a multiple of inAlign bytes.
outAlign
Each scan line in the output buffer is a multiple of outAlign bytes.
Converts image data in a buffer from one color conversion model to another directly using built in algorithms.

Syntax

Visual Basic (Declaration) 
Public Overloads Shared Sub ConvertDirect( _
   ByVal srcFormat As ConversionColorFormat, _
   ByVal destFormat As ConversionColorFormat, _
   ByVal srcBuffer() As Byte, _
   ByVal srcBufferOffset As Integer, _
   ByVal destBuffer() As Byte, _
   ByVal destBufferOffset As Integer, _
   ByVal width As Integer, _
   ByVal height As Integer, _
   ByVal inAlign As Integer, _
   ByVal outAlign As Integer _
)
Visual Basic (Usage)Copy Code
Dim srcFormat As ConversionColorFormat
Dim destFormat As ConversionColorFormat
Dim srcBuffer() As Byte
Dim srcBufferOffset As Integer
Dim destBuffer() As Byte
Dim destBufferOffset As Integer
Dim width As Integer
Dim height As Integer
Dim inAlign As Integer
Dim outAlign As Integer
 
RasterColorConverter.ConvertDirect(srcFormat, destFormat, srcBuffer, srcBufferOffset, destBuffer, destBufferOffset, width, height, inAlign, outAlign)
C# 
public static void ConvertDirect( 
   ConversionColorFormat srcFormat,
   ConversionColorFormat destFormat,
   byte[] srcBuffer,
   int srcBufferOffset,
   byte[] destBuffer,
   int destBufferOffset,
   int width,
   int height,
   int inAlign,
   int outAlign
)
C++/CLI 
public:
static void ConvertDirect( 
   ConversionColorFormat srcFormat,
   ConversionColorFormat destFormat,
   array<byte>^ srcBuffer,
   int srcBufferOffset,
   array<byte>^ destBuffer,
   int destBufferOffset,
   int width,
   int height,
   int inAlign,
   int outAlign
)

Parameters

srcFormat
Format of the input data.
destFormat
Format of the output data.
srcBuffer
A byte array containing the input buffer.
srcBufferOffset
Offset to the first byte of the srcBuffer data buffer.
destBuffer
A byte array that will hold the converted data.
destBufferOffset
Offset to the first byte of the destBuffer data buffer.
width
Width of pixels to be processed.
height
Height of pixels to be processed.
inAlign
Each scanline in the input buffer is a multiple of inAlign bytes.
outAlign
Each scan line in the output buffer is a multiple of outAlign bytes.

Example

This example will convert cmyk color to rgb color, using ConvertDirect static method.

Visual BasicCopy Code
Public Sub ConvertDirectExample()
   ' StartUp the ColorConversion.
   RasterColorConverter.Startup()

   ' Rgb and Cmyk color buffer arrays
   Dim rgbColor(3) As Byte
   Dim cmykColor() As Byte = {100, 100, 100, 100}

   Try
      ' direct conversion using built in options
      ' The srcBufferOffset is an offset that indicates the beginning of the data in the sourec buffer.
      ' for example, if the data in the source buffer starts at byte 5, then this parameter = 5.
      ' in our case here, the image data starts at byte 0.
      ' The same thing applies to destBufferOffset.

      ' The cmykColor is a bytes array, you can pass it directly like this example,
      ' or you can pass an IntPtr pointer to the buffer.
      ' The same thing applies for rgbColor.
      RasterColorConverter.ConvertDirect( _
         ConversionColorFormat.Cmyk, _
         ConversionColorFormat.Rgb, _
         cmykColor, _
         0, _
         rgbColor, _
         0, _
         1, _
         1, _
         0, _
         0)
   Catch ex As Exception
      MessageBox.Show(ex.Message)
   End Try
   '.
   '.
   '.
   ' use rgbColor as you need.

   ' Shutdown the ColorConversion.
   RasterColorConverter.Shutdown()
End Sub
C#Copy Code
public void ConvertDirectExample() 
{ 
   // StartUp the ColorConversion. 
   RasterColorConverter.Startup(); 
 
   // Rgb and Cmyk color buffer arrays 
   byte[] rgbColor = new byte[3]; 
   byte[] cmykColor = {100, 100, 100, 100}; 
 
   try 
   { 
      // direct conversion using built in options 
      // The srcBufferOffset parameter is an offset to the start byte of the data in the source buffer. 
      // For example, if the image data started at byte 5, then this variable should = 5. 
      // in our case here, the image data starts at byte 0. 
      // The same thing applies to destBufferOffset. 
 
      // The cmykColor is a bytes array, you can pass it directly like this example, 
      // or you can pass an IntPtr pointer to the buffer. 
      // The same thing applies for rgbColor. 
      RasterColorConverter.ConvertDirect( 
         ConversionColorFormat.Cmyk, 
         ConversionColorFormat.Rgb, 
         cmykColor, 
         0, 
         rgbColor, 
         0, 
         1, 
         1, 
         0, 
         0); 
   } 
   catch(Exception ex) 
   { 
      MessageBox.Show(ex.Message); 
   } 
 
   //. 
   //. 
   //. 
   // use rgbColor as you need. 
 
   // Shutdown the ColorConversion. 
   RasterColorConverter.Shutdown(); 
}

Remarks

There is no need to call RasterColorConverter.Start and Stop methods to initialize or stop the conversion engine.
Converting from any color space to YCCK color space is currently not supported.
For more information about Alignment Parameters, refer to Alignment Parameters.

Requirements

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

See Also